---
title: 환경 변수 API 참조
sidebar:
  label: 'astro:env'
i18nReady: true
tableOfContents:
  minHeadingLevel: 2
  maxHeadingLevel: 6
---
import Since from '~/components/Since.astro';
import ReadMore from '~/components/ReadMore.astro';

<p><Since v="5.0.0" /></p>

Astro의 `astro:env` API를 사용하면 설정한 환경 변수에 대한 타입 안전 스키마를 구성할 수 있습니다. 이를 통해 서버 또는 클라이언트에서 사용 가능한지 여부를 표시하고, 데이터 타입과 추가 속성을 정의할 수 있습니다. 예시와 사용 방법은 [`astro:env` 가이드](/ko/guides/environment-variables/#타입-안전-환경-변수)를 참조하세요.

## `astro:env`에서 가져오기

```js
import { 
  getSecret,
 } from 'astro:env/server';
```

### `getSecret()`

<p>
<Since v="5.0.0" />
</p>

`getSecret()` 헬퍼 함수를 사용하면 키를 통해 환경 변수의 원시 값을 검색할 수 있습니다.

예를 들어, 불리언 값을 문자열로 검색할 수 있습니다:

```js
import {
  FEATURE_FLAG, // boolean
  getSecret
} from 'astro:env/server'

getSecret('FEATURE_FLAG') // string | undefined
```

이는 데이터베이스나 API의 동적 데이터에 의존하는 것과 같이 스키마에 정의되지 않은 비밀을 가져오는 데에도 유용할 수 있습니다.

프로그래밍 방식으로 환경 변수를 검색해야 하는 경우, `process.env` (또는 이와 동등한 것) 대신 `getSecret()`를 사용하는 것이 좋습니다. 구현이 어댑터에 의해 제공되므로 어댑터를 전환할 때 모든 호출을 업데이트할 필요가 없습니다. 개발 및 빌드 시에는 기본적으로 `process.env`를 사용합니다.
